browserDocumentFailed

Type

message

Summary

Sent when a browser object has encountered an error when loading a url

Syntax

browserDocumentFailed <pInstanceId>, <pUrl>, <pErrorMessage>

Description

The browserDocumentFailed message is sent to the current card of a stack containing a browser object when the browser object has encountered an error while loading a url and all its dependent resources.

If the target is the main frame of the browser (e.g. the html page with the "FRAMESET" declaration), then the browserDocumentFailed message is sent. Otherwise the browserDocumentFailedFrame message is sent instead.

note

For general information on using the browser library, see the notes in the revBrowserOpen function reference.

Parameters

Name	Type	Description
pInstanceId		The integer identifier of the browser object
pUrl		The url that has failed to load
pErrorMessage		A message explaining why the url failed to load

Examples

on browserDocumentFailed pInstanceId, pUrl, pErrorMessage
  answer "Failed to load URL" && quote \
        & pUrl & quote & return & "Error message: " && pErrorMessage
end browserDocumentFailed

Related

message: browserDownloadRequest, browserDocumentFailedFrame

function: revBrowserOpenCef, revBrowserOpen

glossary: function, message

Compatibility and Support

Introduced

LiveCode 6.7.3

OS

mac

windows

Platforms

desktop